Carbon


GetControlValue

Header: Controls.h Carbon status: Supported

Obtains a control’s current setting.

SInt16 GetControlValue (
    ControlRef theControl
);
Parameter descriptions
theControl

On input, a handle to a control.

function result

The current setting of the control, which is stored in the contrlValue field of the control structure.

DISCUSSION

When you create a control, you specify an initial setting either in the control resource or in the value parameter of the function NewControl. You can change the setting by calling SetControlValue.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)